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APPLICATION SERVER AND METHOD TO PERFORM 
HIERARCHICAL CONFIGURABLE DATA MANIPULATION 



FIELD OF THE INVENTION 
[0001] The present invention relates to an application properties server and method to 

provide software manipulation services for clients. More particularly, the present 
invention relates to a system and a method for allowing applications software using 
established computer network protocols to execute hierarchical configurable data 
manipulation from a centralized database. 

\q BACKGROUND OF THE INVENTION 

P002] Computer applications ("application servers") commonly require input data to be 

W manipulated prior to additional processing. The manipulation requirements are often 

^ dynamic. For example, manipulation requirements for a telephone service provider's 

17* software applications may change based on changed customer service availability, newly 

13 available or no longer available customer services, the number of customer requests in a 

\& given period, the acceptable times for requests, or the version of the software running. 

[0003] In today's networked environment, application servers run a variety of different 

software protocols (e.g., J2EE Containers with CORBA orbs, J2EE Containers with RMI) 
and typically require a number of different data manipulations before performing other 
functions. As a result, a need exists for an application server that can dynamically 
maintain, process and efficiently run manipulations for a plurality of clients running 
different software protocols simultaneously. A further need exists for solving the common 
business problem of continually needing to translate, manipulate, or to otherwise conform 
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data that is input by a user or used by an application, prior to further processing or storing 
of the data, with dynamically maintainable manipulation functions. 
[0004] Further, because data manipulation requirements often change, a need exists for a 

manipulation application server that can perform the manipulations run on specific fields 
of client manipulation requests without requiring extensive changes in software. Most 
computer software applications use configuration variables to alter its behavior without the 
need for regenerating code. This is most often done using text files. In today's Internet 
and networked environments this can cause administrative problems. This is largely 
because the same software application may be running on several machines, in several 
locations. Thus, in order to alter uniformly the behavior of all software applications, or 
I s * clients, all files need to be accessible by the text files. This can cause great expense and 

^ significant administration problems. For one thing, security considerations often dictate 

that a text file employed to alter a software application must be on the same machine that is 
H running the code. Therefore, the configuration file often must be replicated over several 

O machines. If changes are made on one software application, they must also be made on all 

j4 of the other applications. Errors can occur if the changes are not made consistently on all 

of the applications. Accordingly, a further need exists for an application server that will 
allow application server administrators to update the various manipulations done on fields 
of data without a new release of code. 

SUMMARY OF THE INVENTION 
[0005] The present invention is a system and method wherein application servers using 

standard software protocols may access a centralized, maintainable, manipulation 
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application server coupled to a data schema for providing manipulation services. The 
client servers may access the manipulation server via a number of methods including 
Internet applications, a Java RMI server, a CORB A gateway server and graphical screen 
interphase applications. The manipulation application server provides manipulation 
services on the data based on dynamically maintained, centrally stored, manipulation 
functions, and returns manipulation notifications to, or provides additional services for, the 
client servers. According to embodiments of the present invention, data is received from 
user clients, manipulated by an application server via stored, dynamically maintained 
functions, which are invisible to the user clients, and returned to the user clients for further 
?p use or storage. 

jU BRIEF DESCRIPTION OF THE DRAWINGS 

f8006] Figure 1 is a schematic diagram of an overview of the present invention. 

|0007] Figure 2 shows an illustrative example of a specific embodiment of the present 

p invention. 

DETAILED DESCRIPTION OF THE INVENTION 
[0008] As shown in Figure 1, the present invention preferably includes an application 

properties server 100 for receiving manipulation requests from clients 400 and a storage 
mass 200 for storing centralized manipulation functions and data. As will be appreciated 
by those skilled in the art, manipulation properties application server 100 may be 
represented by one or more servers, even if located in different geographic locations. In 
the preferred embodiment of the present invention, depending on system resources, a 
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number n of clients 400 may access the manipulation application server 100 for 
manipulation service via a number of methods including, for example, clients 401 using 
Internet applications, clients 402 using Java via a Java RMI server (not shown), clients 403 
using CORBA via a CORBA gateway server (not shown), and clients using graphical 
screen interphase applications. 
[0009] Referring to Figure 1, according to an embodiment of the present invention, clients 

send manipulation requests to the application server 100 which then accesses storage mass 
200 using a hierarchical rule-based system 500 (Figure 2). The manipulation application 
server 100 identifies and accesses the stored data and performs manipulation services 
tp associated with the manipulation requests. Preferably tables of manipulation functions, or 

H rules, implement the manipulation data, which may preferably be stored in a storage mass 

^ such as an Oracle database. As described hereinbelow, by utilizing a table-based storage 

]** system, the application server of the present invention can efficiently and dynamically 

I j perform manipulation services on manipulation requests provided by a number n of clients. 

$§010] Referring to Figure 1, client 401 requests manipulated services related to data for, 

\^ for example, long distance ordering information such as valid installation dates, available 

installation dates, the allowable number of telephones, etc. Storage mass 200 contains a 
plurality of data tables 210, 220, 230, . that will be described below. In response to 
client 401's manipulation requests, manipulation properties server 100 provides 
manipulation services to client 401 by accessing storage mass 200. Similarly, and possibly 
simultaneously, a client 402 running a Java application program can use RMI via an RMI 
interface to interact with properties server 1 00 and manipulation of data based on 
information stored in storage mass 200. Finally, a third client, running a CORBA 
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application 403 may also request manipulation service on data related to, for example, 
Wireless Ordering. Again, manipulation properties server 100 accesses storage mass 200 
and performs a manipulation service for client 403. 

[0011] The manipulation data may be stored in a format such as Oracle or a Lightweight 

Directory Access Protocol ("LDAP"). The information may be stored in another location 
or may be shared with other businesses. Preferably, manipulation data is stored in a table 
based system, more preferably in an Oracle database 200. As will be appreciated by those 
skilled in the art, use of an Oracle database allows for good performance, data integrity, 
and a wide variety of data management tools to administer the configuration data via an 

m administration system 300. As will also be appreciated by those skilled in the art, Oracle 

I s * database 200 may be represented by two or more databases located in separate 

^ geographical locations. 

f fd012] Figure 2 depicts a more specific embodiment and example of the present invention, 

wherein the database 200 consists of a table-based system of rules organized into three 
R hierarchically-organized views: FIELD, CLASS and GLOBAL. The three views allow a 

jsfc hierarchical management of the manipulations to be performed on data fields received 

from the client server 400. In the preferred embodiment, the three views are FIELD, 
CLASS and GLOBAL in order of precedence. Of course, the number of views may vary 
depending on the client's needs. Other embodiments of the present invention include four 
or more views. 

[0013] Each of the FIELD, CLASS and GLOBAL views has an execution sequence. 

Utilizing an execution sequence provides a layered approach, and thereby a hierarchical 
approach to performing manipulation requests, and yields efficient results in this 



5 



embodiment. According to the execution sequence for a particular view, several 
manipulation methods can be orderly executed on data for a matching field. 

[0014] Before providing a specific example, the FIELD, CLASS and GLOBAL views are 

explained below. In the preferred embodiment, the FIELD view is the highest priority 
manipulation. Preferably, for efficiency reasons, the least amount of data is sorted by the 
FIELD view. If a FIELD name for the associated application is in this table that entry will 
dictate the manipulations to be performed. 

[0015] As an example of one embodiment of the present invention, referring to Table 1, 

the FIELD view contains the following data: 



Column Name 


Description 


Tag Name 


Name of data field used to locate 
manipulations 


Application Name 


Application tag to differentiate field names 
from those in other applications. 


Application Version 


Application tag to differentiate field names 
from those in other versions of the same 
application. 


Application User 


Application tag to differentiate field names 
from those in other instances of an 
application and version for different users. 


Execution Sequence 


A number designating the order of 
execution for the 1 or more manipulation 
methods for an item meeting the previous 
criteria. 


Manipulation Method 


The name of an existing Java method to be 
called with the value of the field to be 
manipulated. 


Manipulation Values ("PARM Data") 


Used by the manipulation method to 
compare to the data value. Presence 
determined by manipulation method. Items 
are separated by a predefined character 
(generally a ",") (e.g., 1,5; 20020901, 
20020601) 


Comment 


Description of desired rule. Used for 
documentation only. 



TABLE 1 
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[0017] In the preferred embodiment, the CLASS view is the second-highest priority 

manipulation. The CLASS view is used if there is no matching entry in the FIELD view. 
In such a case, the manipulation application server 100 will perform a lookup on the 
passed field name. The manipulation application server 100 will check for class names 
that match the first part of the field name. An illustrative example is discussed below to 
describe the FIELD and CLASS view hierarchy. 
[0018] Example 1 : No Addresss_l .Data . A client application server 400 accesses the 

manipulation application server 1 00 with the field name of Address l . However, the user 
o has actually input no Address_l data. Thus, there is no Address_l item in the FIELD 

=0 view. There is, however, an entry in the class view for Address. Therefore the 

!P manipulation functions for the class Address will be performed on the data in Address_l . 

';[§>019] As an example of one embodiment of the present invention, referring to Table 2, 

P s s 



the CLASS view contains the following data: 



Column Name 


Description 


Tag Name 


A generic string that will be used to match 
the field's name up to a defined character. 
(Date_l will match up with Date) 


Application Name 


Application tag to differentiate field names 
from those in other applications. 


Application Version 


Application tag to differentiate field names 
from those in other versions of the same 
application. 


Application User 


Application tag to differentiate field names 
from those in other instances of an 
application and version for different users. 


Execution Sequence 


A number designating the order of 
execution for the 1 or more manipulation 
methods for an item meeting the previous 
criteria. 


Manipulation Method 


The name of an existing Java method to be 
called with the value of the field to be 
manipulated. 
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Manipulation Value 1 ("P ARM Data") 


Used by the manipulation method to 
compare to the data value. Presence 
determined by manipulation method. Items 
are separated by a predefined character 
(generally a ",") 


Comment 


Description of desired rule. Used for 
documentation only. 



TABLE 2 



Finally, in the preferred embodiment, the GLOBAL view is the most generic 
method of performing manipulation functions. Any field that does not have an entry in 
either the FIELD or CLASS view will be manipulated with the methods dictated for the 
associated application information. As this view is generic, preferably the most data is 
handled at the GLOBAL level, thereby improving efficiency. Examples are now discussed 
below describing the hierarchy between the FIELD, CLASS and GLOBAL views. 

Example 2: The field name is Residence_2. There is no Residence_2 item in the 
FIELD view. There is no Residence entry in the CLASS view. There is, however, a 
GLOBAL manipulation function called toUpper in the GLOBAL table for the application 
400 (name, version and user) that requires data manipulation. Therefore, in this example, 
the data for Residence_2 will be converted to all uppercase letters and manipulation 
properties server 100 will provide an appropriate return to client 400. 

In the preferred embodiment, each of the FIELD, CLASS and GLOBAL views has 
an execution sequence for the associated manipulation functions that exist for that view. 
This provides a layered approach to manipulation. An example for describing the 
execution sequence is described below. 

Example 3 : Field Name: Date 1 . 
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[0024] Referring to the illustrative table below, in this illustrative example there is no 

match for Field Name: Date l in the FIELD view. However, there are manipulation 
executions in the FIELD view table for LastDay, 4digitYear and FirstDay. The 
manipulation properties server 100 recognizes that the CLASS view table has a matching 
item called Date. An example of the CLASS view table is as follows: 





Application 


Application 


Application 


Execution 


Manipulation 


Manipulation 




Tag Name 


Name 


Version 


User 


Sequence 


Method 


Value 1 


Comment 


Date 


Appll 


001 


EMRS1 


10 


LastDay 


12/31/2002 




Date 


Appll 


001 


EMRS1 


1 


4digitYear 






Date 


Appll 


001 


EMRS1 


5 


FirstDay 


01/01/1996 





[0025] In this exemplary example, based on the Execution Sequence of "1", the date is 

^ first converted to a four-digit year (if necessary by manipulation method "4digityear"). 

'{2 Next, based on the next rule, which has an execution sequence of "5", the date data will be 

i in 

III converted to 01/01/1996 if it is not prior to that date using the FirstDay method. Next, the 

m date will be converted to 12/31/2002 if it is after that date with the LastDay method based 

13 on the Manipulation Value 1 PARM data in the CLASS view table. Finally, the server 100 

will return the converted data to the requesting client application server 400. As will be 
appreciated, this is an example illustrating a "CLASS" level manipulation. 
[0026] The table below illustrates examples of proposed manipulation functions: 



Return Type 


Function Name 


Argument 1 


Argument 2 


Argument 3 


Argument 4 


Boolean 


ManipulatelntegerField 


String Field Name 


Integer Field Data 


Integer Min Value 


Integer Max Value 


Boolean 


ManipulateString Field 


String Field Name 


String Field Data 




Integer Max Value 


Boolean 


ManipulateDateRange 
Field 


String Field Name 


String Field Data 


Earliest Date 


Latest Date 



[0027] Figure 2 depicts further example manipulations performed by an exemplary 

embodiment of the present invention. In this embodiment, client application server Long 
Distance Delivery Ordering ("LD ORD") 400 seeks to manipulate data input by a 
customer, such as user name, the type of service requested, the date available for service, 
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the date of expiration related to a desired telephone service, etc. Accordingly, using a 
known software application protocol, application server LD ORD 400 sends manipulation 
requests related to the data input by a customer to the manipulation application server 1 00. 
As a first example, the user's name is tag named "User_Name" and has been input as 
"John Doe". The server 100 notes that the application LD ORD, version 1.0, has generated 
a request for service. Accordingly, the manipulation application server 100 generates an 
instruction to call the FIELD view table from the storage medium 200 for User_Name. In 
this example, the application server 100 automatically follows the priority of rules stored 
and dynamically maintained in the database 500. Here, there is only one rule, i.e., one Java 
p Function, for User_Name, which is applicable to any user of LD ORD, version 1 .0. As 

^ shown in Figure 2, the Java method associated with User Name rule is ToUpperCase 

y method. Accordingly, the manipulation server 100 checks to see if the input data is all 

^ uppercase while also checking for PARM data. Here, if the input data is not all uppercase, 

~j the manipulation server 100 converts the data to all uppercase for client 400 and provides 

3 an appropriate return to client 400. Of course, if the input data is all uppercase the 

& manipulation server 100 returns an appropriate response to client 400. 

[0028] Next, according to the example depicted in Figure 2, the manipulation server 100 

performs manipulation service on manipulation requests for data input by a user for date of 
service, which has been tagged DATE_Serv. Here, database 200 presently has no FIELD 
view rules for any users of LD ORD, version 1 .0, data tagged DATE_Serv. However, in 
the preferred embodiment, the manipulation server 100 will automatically perform two of 
three available Java-based CLASS view functions, based on the PARM data and execution 
sequence of the three presently available CLASS view rules, on the data tagged 
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DATE_Serv, thereby converting the input data 4/01/02 to 20020415. First, the server 
performs a 4digityear function, and then the server performs a FirstDay function. In this 
example, the function LastDay is not performed because the PARM data is past the input 
date. Here again, server 100 provides an appropriate response to client 400. As shown in 
Figure 2, the application server 100 will read the execution sequences to determine which 
Java function to perform first. Java function 4digityear has an execution sequence of "1" 
and Java function FirstDay has an execution sequence of "5". Based on this sequence of 
execution set forth in this CLASS view, the manipulation server 100 executes first the 
4digityear function and then the FirstDay function on the data. As will be appreciated by 
0 those skilled in the art, in this example, if there were no DATE rules, manipulation 

f application server 100 would automatically look for GLOBAL rules in the GLOBAL-view 

J table. Of course, in other embodiments, the server 1 00 could prompt the user for 

" additional information or generate prompts between class levels. In other embodiments, 

Zj further services may be provided in response to manipulated data being returned to the 

3 client, such as additional data manipulations, generation of further functions, etc. In one 

^ embodiment, the manipulated data is displayed on a user's screen for approval before 

further processing. 

[0029] Referring again to Figure 2, next, LD ORD 400 requests manipulation service on 

data related to the date of availability for a requested telephone service. This data has been 
tagged DATE_5. The priority of rules 500 indicates that presently there is one rule in the 
FIELD view, i.e., there is one manipulation function, for DATE_5. Therefore, the 
manipulation application server 100 performs a FirstMonth function on the data tagged 
DATE 5. 
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As shown in Figure 2, in some instances, server 100 will have rules for specific 
users of specific versions of application LD ORD. Additionally, database 200 may contain 
various GLOBAL methods (e.g., ALL) data used by any user of LD ORD. As will be 
appreciated, the server 100 provides great flexibility for dynamically providing many 
manipulation functions for a plurality of clients. 

As will also be appreciated, by utilizing a centrally located storage system of 
dynamically maintainable manipulation rules, the present invention provides greater 
flexibility than known systems. For example, in the exemplary example discussed above 
system administration 300 (Figure 1) can change the PARM data for DATE S and, 
accordingly, all applications 400 requesting manipulation services for data related to 
DATE_5 are contemporaneously updated. 

In some instances, the number of manipulation requests may be large depending on 
the number n of application clients 400 using the server 100. Constant database 200 reads 
may cause delays in manipulation service. Therefore, in one exemplary embodiment, the 
manipulation server 100 will read the database 200 data 500 into memory on startup. 
Updates to the manipulation rules and values stored in the data tables can occur after 
system start up. 

Two exemplary methods to handle dynamic table updates are described below. 
The first method is to restart the manipulation application server 100 each night during a 
maintenance window. This approach is a simple restart of the manipulation server. The 
application itself would not have to restart since it could detect the lost connection to the 
manipulation server and reconnect. This would be seamless to the applications and end 
user of the applications. Another exemplary method involves creating a refresh function 



12 



in the manipulation server 100. Preferably the server 100 will use a REFRESH HOURS 
parameter. The memory tables will be updated from the database 200 based on this 
parameter. Preferably, the REFRESH_HOURS will be greater than 8. As will be 
appreciated, keeping the data 500 in the application server 100 memory will improve 
manipulation performance and allow or maintaining the dynamic nature of the 
manipulation routines. 

[0034] The most generic field type in Java is the string. In the preferred embodiment, all 

data passed to the manipulation server 1 00 will be treated as a string. This will allow 
applications 400 to change to more generic data without impact. This embodiment will 

?0 provide an interface that is generic as possible by establishing the interface as Strings 

H (ASCII). An example of this concept is set forth below. 

5($035] For example, originally a business requirement required a date value for a Date of 

Birth variable. The requirement for the legacy system required the date with a two-digit 
I Tj year. The value of the field data from the data source is "02/3 1/2002." However, testing 

s E J: 

p with the legacy system shows that the legacy system actually needs a four-digit year. 

H Because the application is using the manipulator server 100, a code change is avoided. 

Since the integer values can be type cast to String and passed to the manipulation server 
100, modifications to the rules can be made quickly. Modifications to types would cause 
the manipulation server 100 to understand application knowledge and not data values and 
manipulation rules. Here, the manipulation method can be changed from 2digityear to 
4digityear. Accordingly, the output dates will now have the correct format for the legacy 
application. 
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[0036] According to the present invention, since the variable is stored as a string, the client 

code is not affected. Changes to manipulation functions may be done without disturbing 
the running applications that utilize this manipulation service. 

[0037] Proposed ManipulatorClient CLASS methods include: 



Method 


Return 
Type 


Arguments 


Description 


ManipulatorClient 


ManipulatorClient 


Application 

Name, 

Application 

Version, 

Application 

User 


Class constructor. Also used to 
initialize Application data for 
subsequent calls 


ManipulatorClient 


ManipulatorClient 




Class constructor. 


ManipulatorClient 


ManipulatorClient 




Class destructor 


set 




Application 

Name, 

Application 

Version, 

Application 

User 


Sets application data settings for 
the object. 


translate 


Boolean 


Field Name, 
Field Value 


Sends data to the manipulator 
server for work. If the data is 
successfully translated, a TRUE 
is returned. Otherwise; a FALSE 
is returned. 


translate 


MRHashTable 


FMHashTable 


Sends data to the manipulator 
server for work. If the data is 
successfully translated, a TRUE 
is returned. Otherwise; a FALSE 
is returned. 


RuleType 


Integer 


Field Name 


Gets the rule type used for 
manipulation - 0 = None, 1= 
Field, 2= Class, 3=Global {Used 
primarily for development} 



TABLE 3 



[0038] In one embodiment, the client servers 400 can minimize network traffic using Field 

Value Hashtables. As will be appreciated, this will reduce the number of transactions to 
the manipulation application server 100 and improve performance. One call to the server 
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100 can contain an entire set of data in need of manipulation. The individual manipulation 
statuses will also be returned in a Hashtable. Preferably, the IsValid method is used to 
determine if all the data passed manipulation. If not, individual methods can be checked to 
determine problem areas. 
[0039] Proposed FMHashTable CLASS methods include: 



Method 


Return 
Type 


Arguments 


Description 


FMHashTable 


FMHashTable 




Constructor for a Field Value 
HashTable object. 


AddToSet 


Boolean 


Field Name, 
Field Value 


Add a field value pair to the 
FVHashTable. Return True on 
success. 


RemoveFromSet 


Boolean 


Field Name 


Remove a field value pair from the 
FVHashTable. Return True on 
success. 


MemberValue 


String 


Field Name 


Return the value of the specified 
key. 



TABLE 4 



10)040] Proposed MRHashTable CLASS methods: 



Method 


Return 
Type 


Arguments 


Description 


MRHashTable 


MRHashTable 




Constructor for a Manipulator 
Return HashTable object. 


AddToSet 


Boolean 


String Field 
Name, 

Boolean Valid 


Add a field value pair to the 
MRHashTable. Return True on 
success. 


RemoveFromS et 


Boolean 


String Field 
Name, 


Remove a field value pair from the 
MRHashTable. Return True on 
success. 


MemberValue 


Boolean 


Field Name 


Return the manipulation status 
value of the specified key. 


IsValid 


Boolean 




Returns a True if all values for the 
set are True. Otherwise; returns a 
False. 



TABLE 5 
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[0041] As will be appreciated, according to the embodiments discussed above, two devices 

that are coupled can engage in direct communications, in indirect communications or a 
combination thereof. Embodiments of the present invention relate to data communications 
via one or more networks. The data communications can be carried by one or more 
communications channels of the one or more networks. Examples of a network include a 
Wide Area Network (WAN), a Local Area Network (LAN), the Internet, a wireless 
network, a wired network, a connection-oriented network, a packet network, an Internet 
Protocol (IP) network, or a combination thereof. A network can include wired 
communication links (e.g., coaxial cable, copper wires, optical fibers, and so on), wireless 
*g communication links (e.g., satellite communication links, terrestrial wireless 

H communication links, wireless LANs, and so on), or a combination thereof 

!p)042] In accordance with an embodiment of the present invention, instructions adapted to 

■ * y be executed by a processor to perform a method are stored on a computer-readable 

l*\ medium. The computer-readable medium can be a device that stores digital information, 

fj For example, a computer-readable medium includes a compact disc read-only memory 

\ a (CD-ROM) as is known in the art for storing software. The computer-readable medium is 

accessed by a processor suitable for executing instructions adapted to be executed. The 
term "adapted to be executed" is meant to encompass any instructions that are ready to be 
executed in their present form (e.g., machine code) by a processor, or require further 
manipulation (e.g., compilation, decryption, or provided with an access code, etc.) to be 
ready to be executed by a processor. 
[0043] Systems and methods in accordance with the embodiments of the present invention 

disclosed herein can advantageously allow for efficient hierarchical management of 
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manipulation requests to be performed on data fields. In accordance with the present 
invention, centrally stored manipulation functions can be manipulated as the customer 
desires or manipulation constraints change. Application administrators can update or 
change manipulation methods done on field data without a new release of code. By 
implementing changes to manipulation methods in the server paradigm, one change is 
effective for all server clients. 
[0044] In describing representative embodiments of the present invention, the specification 

may have presented the method and/or process of the present invention as a particular 
sequence of steps. However, to the extent that the method or process does not rely on the 
n particular order of steps set forth herein, the method or process should not be limited to the 

& particular sequence of steps described. As one of ordinary skill in the art would appreciate, 

y other sequences of steps may be possible. Therefore, the particular order of the steps set 

M forth in the specification should not be construed as limitations on the claims. In addition, 

* the claims directed to the method and/or process of the present invention should not be 

^ limited to the performance of their steps in the order written, unless that order is explicitly 

a described as required by the description of the process in the specification. Otherwise, one 

skilled in the art can readily appreciate that the sequences may be varied and still remain 
within the spirit and scope of the present invention. 
[0045] The foregoing disclosure of embodiments of the present invention has been 

presented for purposes of illustration and description. It is not intended to be exhaustive or 
to limit the invention to the precise forms disclosed. Many variations and modifications of 
the embodiments described herein will be obvious to one of ordinary skill in the art in light 



17 



of the above disclosure. The scope of the invention is to be defined only by the claims 
appended hereto, and by their equivalents. 
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